home *** CD-ROM | disk | FTP | other *** search
/ Sun Solutions 1997 April to September / Sun Solutions CD - APR '97 - SEP '97 (704-3778-12 Rev. H)(Sun Microsystems, Inc.)(1997).iso / products / Confluent / note_license.txt < prev    next >
Text File  |  1995-10-17  |  10KB  |  289 lines
  1. ----------------------------------------------------------------------
  2. The Confluent License Server
  3.  
  4. Last update: 16 August 1995
  5.  
  6. Confluent Technical Notes
  7. Copyright (c) 1995 Confluent, Inc.  All rights reserved.
  8. Suggestions or questions to 415-586-8700 or vthought@confluent.com.
  9. ----------------------------------------------------------------------
  10.  
  11. This technical note describes the Confluent license server, its
  12. interaction with Visual Thought, and its use in special system
  13. configurations.
  14.  
  15.  
  16. License Directory
  17. -----------------
  18. The following license directory is created during installation of
  19. Visual Thought (assuming Visual Thought has been installed in
  20. /usr/local/confluent):
  21.  
  22.   /usr/local/confluent/license
  23.  
  24. Both the confluent_a script and Visual Thought will use this directory
  25. for storage and retrieval of licensing information.
  26.  
  27.  
  28. License Keys
  29. ------------
  30. License keys for Visual Thought are installed with:
  31.  
  32.   confluent_a key vthought
  33.  
  34. This creates a license key file (e.g., 01.lic) in the license
  35. directory.  The key file contains the name of the license server host
  36. on which the key was installed.
  37.  
  38. Visual Thought and the license server use license key files to
  39. determine information such as authorized license server hosts, number
  40. of authorized licenses, and license expiration.
  41.  
  42.  
  43. License Server Communication
  44. ----------------------------
  45. When Visual Thought runs, it attempts to request a license from either
  46. a local or remote license server.  Communication between Visual
  47. Thought and the license server is accomplished using UDP messages via
  48. port number 1484.
  49.  
  50. Port 1484 should be unique to the Confluent license server.  It was
  51. obtained from the Internet Assigned Numbers Authority (IANA).
  52. However, if this port is already used, an alternate port number can be
  53. used by adding the following line to the /etc/services file:
  54.  
  55.   confluent_elmd  xxxx/udp
  56.  
  57. where "xxxx" is the port number.  The port number must be greater than
  58. 1024.
  59.  
  60. WARNING: You cannot successfully use an alternate port number by
  61. changing the confluent_a script to add the "-p" option to the
  62. confluent_lm command.  This merely tells confluent_lm to use an
  63. alternate port number.  It has no effect on the port number used by
  64. Visual Thought to request a license from the license server.
  65.  
  66.  
  67. Evaluation Licenses
  68. -------------------
  69. For an evaluation license (i.e., the type supplied for purposes of
  70. product evaluation), Visual Thought always assumes that the license
  71. server is running on the local host.  If it is not running, Visual
  72. Thought starts it automatically with:
  73.  
  74.   confluent_a start
  75.  
  76. Visual Thought attempts to request a license from a license server
  77. running on the local host.
  78.  
  79. The following is required to set up the license server for an
  80. evaluation license:
  81.  
  82.   1. Install the license key on any host with:
  83.  
  84.        confluent_a key vthought
  85.  
  86.      The host must have write access to the license directory.
  87.  
  88.   2. Start the license server on the host where Visual Thought will be
  89.      running with:
  90.  
  91.        confluent_a start
  92.  
  93.      This step is optional, since Visual Thought will automatically start
  94.      the license server if it is not running.
  95.  
  96.  
  97. Permanent Licenses
  98. ------------------
  99. For a permanent license (i.e., the type supplied when Visual Thought
  100. is purchased), the license key is only valid for installation on a
  101. single host machine.  The valid host is specified through the host
  102. server code obtained by executing the following on the host:
  103.  
  104.   confluent_a code
  105.  
  106. The host server code output by the above command must be provided to
  107. Confluent to obtain a permanent license key.
  108.  
  109. Visual Thought obtains the name of the license server host from the
  110. license key file.  If this host is the local host and the license
  111. server is not running, Visual Thought starts it automatically with:
  112.  
  113.   confluent_a start
  114.  
  115. Visual Thought attempts to request a license from a license server
  116. running on the local or remote host, as specified by the license key
  117. file.
  118.  
  119. The following is required to set up the license server for a permanent
  120. license:
  121.  
  122.   1. Kill all currently running license servers with:
  123.  
  124.        confluent_a kill all
  125.  
  126.      This will kill license servers started on the local and remote
  127.      hosts for any previously installed evaluation and permanent licenses.
  128.      This step is important to prevent license servers for evaluation
  129.      licenses from creating problems locating the license server for the
  130.      permanent license.
  131.  
  132.   2. Install the license key on the license server host with:
  133.  
  134.        confluent_a key vthought
  135.  
  136.      The host must have write access to the license directory.
  137.  
  138.   3. Start the license server on the license server host with:
  139.  
  140.        confluent_a start
  141.  
  142.      For convenience, this operation can be placed in /etc/rc.local.
  143.  
  144.  
  145. Searching for License Servers Outside the Network Broadcast Mask
  146. ----------------------------------------------------------------
  147. If Visual Thought and Confluent license servers are running on
  148. different subnetworks, the default method for locating a license
  149. server may fail.
  150.  
  151. By default, license servers are located through a system broadcast
  152. message.  The scope of the broadcast is limited to the broadcast mask,
  153. which is normally restricted to the local subnetwork.  The broadcast
  154. mask can be determined with:
  155.  
  156.   ifconfig -a
  157.  
  158. In order to locate license servers on systems outside the broadcast
  159. mask, these systems must be specified with the CONFLUENT_ELMHOST
  160. environment variable.  The value of CONFLUENT_ELMHOST is a
  161. colon-separated list of hosts.  The hosts can be specified either by
  162. name or IP address.
  163.  
  164. The list of hosts can be specified with CONFLUENT_ELMHOST in either
  165. search mode or absolute mode.
  166.  
  167. In search mode, the list of hosts is added to the broadcast list for
  168. the local subnetwork.  Messages are sent in parallel to the hosts in
  169. the list and to all systems on the local subnetwork.  For example,
  170. using
  171.  
  172.   setenv CONFLUENT_ELMHOST host1:host2
  173.  
  174. causes messages to be sent in parallel to host1, host2, and all
  175. systems on the local subnetwork.
  176.  
  177. In absolute mode, no broadcast is done.  Only the hosts in the list
  178. are tried.  If multiple hosts are listed, each is tried in turn until
  179. the timeout period expires.  Absolute mode is specified by preceding
  180. the host list with an at (@) sign.  For example, using
  181.  
  182.   setenv CONFLUENT_ELMHOST @host1:host2
  183.  
  184. causes messages to be sent in turn to host1 and host2.
  185.  
  186.  
  187. Connecting to License Servers on a Slow Network
  188. -----------------------------------------------
  189. Visual Thought must connect to a license server to obtain a license
  190. and become fully functional.
  191.  
  192. On a very slow network or server, attempts to connect to a license
  193. server may fail because of a timeout while waiting for a connection.
  194. The timeout can be prevented by increasing the timeout period.
  195.  
  196. The default timeout period is 15 seconds.  This value can be changed
  197. by setting the ELMTIMEOUT environment variable.  For example,
  198.  
  199.   setenv ELMTIMEOUT 30
  200.  
  201. changes the timeout value to 30 seconds.
  202.  
  203. For very severe network problems, it may also be necessary to change
  204. the number of times a connection attempt is retried.  The default
  205. number of retries is 2 (3 attempts are made to connect).  This value
  206. can be changed by setting the ELMRETRIES environment variable.  For
  207. example,
  208.  
  209.   setenv ELMRETRIES 4
  210.  
  211. changes the number of retries to 4.  It is very unlikely that it
  212. should be necessary to change ELMRETRIES.
  213.  
  214. A total of ELMRETRIES+1 attempts are made to connect to a license
  215. server, spaced ELMTIMEOUT/(ELMRETRIES+1) seconds apart.  Thus, by
  216. default 3 attempts are made, 5 seconds apart.
  217.  
  218.  
  219. Reasons for Failure to Obtain a License
  220. ---------------------------------------
  221. The following are possible reasons why Visual Thought might be unable
  222. to obtain a license.
  223.  
  224. In preparation for the following steps, change the working directory
  225. to the Visual Thought installation directory with (assuming Visual
  226. Thought has been installed in /usr/local/confluent):
  227.  
  228.   cd /usr/local/confluent
  229.  
  230. Modify the above directory path accordingly if Visual Thought was
  231. installed in a different directory.
  232.  
  233. 1. The license directory is unreadable.
  234.  
  235.    Obtain the permissions for the license directory with:
  236.  
  237.      ls -ld license
  238.  
  239.    They should be "drwxrwxrwx" (i.e., all permissions for all users).
  240.    This ensures that all license files are readable and log files in the
  241.    license directory are writable.
  242.  
  243.    If the permissions for the license directory are not "drwxrwxrwx",
  244.    set them with:
  245.  
  246.      chmod 777 license
  247.  
  248. 2. The license files are unreadable.
  249.  
  250.    Obtain the permissions for the license files with:
  251.  
  252.      ls -l license/*.lic
  253.  
  254.    They should be "-rw-r--r--", with at least read permission for all
  255.    users.  If not, set the permissions for the license files with:
  256.  
  257.      chmod 644 license/*.lic
  258.  
  259. 3. No license files are present in the license directory.
  260.  
  261.    Obtain a list of the license files in the license directory with:
  262.  
  263.      ls license/*.lic
  264.  
  265.    The available keys can also be listed with:
  266.  
  267.      confluent_a keys
  268.  
  269.    This generates output of the form:
  270.  
  271.      ID Program  Server     Tokens Type  Starts   Expires 
  272.      -- -------  ------     ------ ----  ------   ------- 
  273.      01 vthought aspen          5  float    --       --   
  274.  
  275.    If there are no license files in the license directory, install
  276.    them with:
  277.  
  278.      confluent_a key vthought
  279.  
  280. 4. Extra incorrect license directories.
  281.  
  282.    Determine the location of all license directories in the
  283.    installation with:
  284.  
  285.      find . -name license -print
  286.  
  287.    The only output should be "./license".  Any other license
  288.    directories located with the above command should be removed.
  289.